package com.bi.mapper;

import com.baomidou.mybatisplus.core.mapper.BaseMapper;
import com.baomidou.mybatisplus.core.metadata.IPage;
import com.baomidou.mybatisplus.extension.plugins.pagination.Page;
import com.bi.entity.ChartComponent;
import org.apache.ibatis.annotations.Mapper;
import org.apache.ibatis.annotations.Param;

import java.util.List;
import java.util.Map;

/**
 * 图表组件Mapper接口
 * 
 * @author BI Platform Team
 * @since 1.0.0
 */
@Mapper
public interface ChartComponentMapper extends BaseMapper<ChartComponent> {

    /**
     * 分页查询图表组件
     * 
     * @param page 分页参数
     * @param params 查询参数
     * @return 分页结果
     */
    IPage<ChartComponent> selectChartComponentPage(Page<ChartComponent> page, @Param("params") Map<String, Object> params);

    /**
     * 根据图表类型查询组件
     * 
     * @param chartType 图表类型
     * @return 组件列表
     */
    List<ChartComponent> selectByChartType(@Param("chartType") String chartType);

    /**
     * 根据状态查询组件
     * 
     * @param status 组件状态
     * @return 组件列表
     */
    List<ChartComponent> selectByStatus(@Param("status") String status);

    /**
     * 查询图表组件统计信息
     * 
     * @return 统计信息
     */
    Map<String, Object> selectChartStatistics();

    /**
     * 根据宽表ID查询相关图表组件
     * 
     * @param wideTableId 宽表ID
     * @return 组件列表
     */
    List<ChartComponent> selectByWideTableId(@Param("wideTableId") Long wideTableId);

    /**
     * 根据数据组件ID查询相关图表组件
     * 
     * @param dataComponentId 数据组件ID
     * @return 组件列表
     */
    List<ChartComponent> selectByDataComponentId(@Param("dataComponentId") Long dataComponentId);

    /**
     * 获取热门图表类型统计
     * 
     * @param limit 限制数量
     * @return 图表类型统计
     */
    List<Map<String, Object>> selectPopularChartTypes(@Param("limit") Integer limit);
}